home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / hash.z / hash
Encoding:
Text File  |  2002-10-03  |  4.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. hhhhaaaasssshhhh((((1111))))                                                                hhhhaaaasssshhhh((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      hhhhaaaasssshhhh - remember or report utility locations
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      hhhhaaaasssshhhh [utility...]
  13.  
  14.      hhhhaaaasssshhhh -r
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The hhhhaaaasssshhhh utility affects the way the current shell environment remembers
  18.      the locations of utilities found as described in Command Search and
  19.      Execution . Depending on the arguments specified, it adds utility
  20.      locations to its list of remembered locations or it purges the contents
  21.      of the list. When no arguments are specified, it reports on the contents
  22.      of the list.
  23.  
  24.      Utilities provided as built-ins to the shell are not reported by hhhhaaaasssshhhh.
  25.  
  26. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  27.      The hhhhaaaasssshhhh utility supports the XBD specification, Utility Syntax
  28.      Guidelines.
  29.  
  30.      The following option is supported:
  31.  
  32.      ----rrrr  Forget all previously remembered utility locations.
  33.  
  34. OOOOPPPPEEEERRRRAAAANNNNDDDDSSSS
  35.      The following operand is supported:
  36.  
  37.      uuuuttttiiiilllliiiittttyyyy   The name of a utility to be searched for and added to the list
  38.                of remembered locations. If utility contains one or more
  39.                slashes, the results are unspecified.
  40.  
  41. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  42.      The following environment variables affect the execution of hhhhaaaasssshhhh:
  43.  
  44.      PPPPAAAATTTTHHHH   Determine the location of utility, as described in the XBD
  45.             specification, Environment Variables .
  46.  
  47. SSSSTTTTDDDDOOOOUUUUTTTT
  48.      The standard output of hhhhaaaasssshhhh is used when no arguments are specified.  Its
  49.      format is unspecified, but includes the pathname of each utility in the
  50.      list of remembered locations for the current shell environment.  This
  51.      list consists of those utilities named in previous hhhhaaaasssshhhh invocations that
  52.      have been invoked, and may contain those invoked and found through the
  53.      normal command search process.
  54.  
  55. EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
  56.      The following exit values are returned:
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. hhhhaaaasssshhhh((((1111))))                                                                hhhhaaaasssshhhh((((1111))))
  71.  
  72.  
  73.  
  74.      0   Successful completion.
  75.  
  76.      >0  An error occurred.
  77.  
  78. AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
  79.      Since hhhhaaaasssshhhh affects the current shell execution environment, it is always
  80.      provided as a shell regular built-in. If it is called in a separate
  81.      utility execution environment, such as one of the following:
  82.  
  83.           nohup hash -r find . -type f | xargs hash
  84.  
  85.      it will not affect the command search process of the caller's
  86.      environment.
  87.  
  88.      The hhhhaaaasssshhhh utility may be implemented as an alias, for example, aaaalllliiiiaaaassss ----tttt ----,
  89.      in which case utilities found through normal command search will not be
  90.      listed by the hhhhaaaasssshhhh command.
  91.  
  92.      The effects of hhhhaaaasssshhhh ----rrrr can also be achieved portably by resetting the
  93.      value of PPPPAAAATTTTHHHH; in the simplest form, this can be:
  94.  
  95.           PATH="$PATH"
  96.  
  97.      The use of hhhhaaaasssshhhh with utility names is unnecessary for most applications,
  98.      but may provide a performance improvement on a few implementations;
  99.      normally, the hashing process is included by default.
  100.  
  101. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  102.      sssshhhh((((1111))))
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.